
Introduction
------------
This is a Linux diag software package for Broadcom NetXtreme II Ethernet network
controllers. After untar the file, it will expand the code tree into 
a directory called lx_xdiag for 32bit kernel or lx_xdiag_x86_64 for 64bit kernel.

Limitations
-----------
* The software only works on Linux 2.6 kernels. i.e. ReadHat4.
* The software is 32bit application. And some tests will fail(e.g. A5 MSI test) 
  if the system memory is bigger than 4GByte.
* The software does not work on 32bit HugeMem kernels right now.

Note: 
* You have to log in as ROOT or do "su - root" to build the device drivers and 
  run xdiag. 
* If the bnx2 driver is loaded, it has to be unloaded first so that the drivers
  for xdiag can be loaded. To check if the bnx2 is loaded, do:
	lsmod | grep bnx2
  if bnx2 is loaded, do:
	rmmod bnx2


To build the device drivers for xdiag
-------------------------------------
Go to lx_xdiag or lx_xdiag_x86_64 and do:

#./drv_build

or do:
# cd drivers/mpd
# make clean
# make
# cd ../kdiag
# clean
# make
# cd ../../

To load the device drivers for xdiag
-------------------------------------
do:

#./drv_install

or do:
# insmod drivers/mpd/bxbdrv.ko
# insmod drivers/kdiag/b06kdiag.ko
# cp libtcl8.3.so /usr/local/lib 
# mknod /dev/bcm_diag c 240 0

To run xdiags:
--------------
do:

# ./xdiag 

To unload the devuce drivers
----------------------------
do:

#./drv_uninstall

or do:

# rmmod b06kdiag
# rmmod bxbdrv
# rm /dev/bcm_diag

To run two cards loop back test
---------------------------------------------
Connect two cards by cross-link Ethernet cable 
and install device drivers first.

Then do:

# ./xdiag -t abcd -T d3 -slave 2


Please refer to DOS xdiag user document for complete usage information.
